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COPYRIGHT 


COPYRIGHT © 1983 by Nicolet Paratronics Corporation. All rights reserved. No 
part of these materials may be reproduced by any means, nor translated into a 


machine language, without the written permission of the publishers. 
LIMITED WARRANTY 


Nicolet Paratronics Corp. ("NPC") guarantees your emulator against all defects in 
materials and workmanship for a period of ninety (90) days from the date of delivery 
to the original user. All instruments returned to NPC FREIGHT PREPAID during 
the ninety day period will be replaced or restored to proper working condition and 
returned to the sender without charge. We neither assume nor authorize any 
representative or other person to assume for us any other liability in connection 


with the sale on any shipment of our products, 


NOTE 


This warranty does not apply to damage caused by 
shipping, negligence, accident, unauthorized repair, 
abuse, rnisuse, or modification; or to inconven- 
iences or consequential damages occasioned by the 
instrument, or by breach of any expressed or 
implied warranty with respect thereto. Further, no 
agreement extending or modifying this warranty in 
any way whatsoever will be binding upon NPC 
unless executed by a duly authorized officer of the 
company. 


This warranty gives you specific legal rights, and you may also have other rights 


which depend on Soca! jurisdiction. 


We reserve the right to make changes and improvements in our products without 


incurring any obligation to similarly alter products previously purchased. 
TRADEMARKS 


NICE is a registered trademark of Nicolet Paratronics Corporation. 


Z80 js a trademark of Zilog. 
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CHAPTER | 
INTRODUCTION 


ABOUT NICE, THE Z80 EMULATOR 


Using only six integrated circuits, NICE (for Z80 emulation) is the first of a new 
first generation of medium-to-high function emulators. Its revolutionary compact 
design provides the following benefits: 


e@ Reduction in Price. NICE's low price finally brings In-circuit emulators 
out of the exclusive domain of large-scale operations and into the reach of 
computer repair shops and hobbyists. 


e  Transportability. NICE is only 2 3/4" square and 1/2" thick. Not only can 
it be used in development labs, it can also be a part of the computer 
technician's portable repair kit. An RS232 compatible interface allows 
NICE to hook up to most terminals and modems for speedy diagnoses. 


e Full Speed Emulation with Minimal Target Disturbance. NICE's compact 
design means the electronics are closer to the target systern than previous 
generation emulators. The result is full speed emulation with minimal 
target disturbance. NICE does not even need a separate power supply and 
the associated wiring. It obtains its power of 500ma @ 5V directly from 
the target system. 


e ase of Operation. NICE's streamlined operation is consistent with its 
streamlined design. All it takes to get started is replacing the Z80 
microprocessor with NICE (either directly or via the 40 pin cable assem- 
bly), connecting the terminal to NICE, resetting the target system, and 
hitting a carriage return. 
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WHO USES IT 
NICE is designed to meet the needs of four groups: 


e@ Designers profit from NICE's ability to aid in debugging both hardware and 
software. Emulators provide a cost-effective means of integrating hard- 


ware and software. 


@ New Product Manufacturers can use NICE to pinpoint potential problems 
before beta testing. uring the manufacturing, NICE can be used to bring 
up virgin CPU cards, then to download and run diagnostics. A more 


trouble-free product leads to greater customer satisfaction. 


@ Computer Repair Technicians can bring NICE along on on-site repair calls, 
possibly eliminating the need for in-shop repair, Smaller computer repair 
shops can finally afford an emulator because of NICE's revolutionary low 
cost. 


@ Serious hobbyists can even use NICE. Its low cost and high versatility 
combine to make it a valuable tool for debugging home systems and 


designing custom hardware or software. 
BASIC FEATURES 


Despite its small size, NICE incorporates most of the features of the less portable 
and more expensive emulators. 


Full speed execution 

Refresh function maintained at all times 
All I/O ports available to user 

All memory addresses available to user 
Three break points with 8 bit loop counters 
Three print points 

Power derived from the target system 
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Interface to user via standard 25 pin RS232 terminal connector 
Local or remote operation 

Automatic baud rate detection 

Small size 

Low cost 


High reliability 


FUNCTIONAL CAPABILITIES 


NICE can: 


Display target systern memory in hexadecimal and ASCII format 
Display and modify any memory location in target system RAM 
Display and/or modify any Z80 internal register 

Examine any I/O port 

Output single or multiple bytes to any I/O port 

Perform hexidecimal arithmetic 

Fill a block of RAM with a constant 

Compare one block of memory to another 

Test target system RAM 

Move a block of rnemory from one location to another 

Read and load an Intel Hex File into target system RAM 

Trace and display all instructions 

Trace and display only specified instructions 

Disassemble memory into Z80 mnemonics 

Assemble Z80 mnemonics into memory 

Enable/ Disable Z80 interrupts in hardware 

Enable/Disable Z80 bus request in hardware 

Enable/Disable 2780 refresh function 
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COMMAND LINE INTERPRETER CHARAC TIC 
E TERISTICS HAPTER 2 


SET-UP 


NICE's versatile command line interpreter allows you to: 


There are two aspects to setting up NICE for Z80 emulation: 
Enter one or more commands on the same line 


Enter a "Sleep" command to delay command execution - 5 
Bat on ete ‘ |. Setting up the terminal, 
-Ater a “repeat Line" cornmand to repeat execution of the command li perc “Sea. - : . . 
: Mis 2. Establishing the communications interface and installing NICE into the target 
Erase the previous character on the command line 


: : system, 
Erase the entire command line 
i : TERMINAL 
Additionally, a printout can be halted, restarted, or aborted. 
Auto Baud Rate Detection 


NICE is equipped with an automatic baud rate detection algorithm that is invoked 
whenever NICE is reset. To determine the proper baud rate, NICE measures the 
length of the first start bit transmitted from the terminal. To start autornatic baud 
rate detection, enter a carriage return following reset. After the baud rate has 
been determined, you will see the NICE copyright notice followed by the OK 
prompt. At this point, you may begin entering commands. 


To work with NICE, the terminal must be set to one of the following baud rates: 


e 150 e 2400 
e 300 e 4800 
e 600 e 9600 
e 1200 e 19.2K 


Terminal Characteristics 


In order to operate with NICE, the terminal must be set up with the following 
characteristics: 


Full duplex operation 
Auto line feed on; carriage return disabled 


Line terminator set to either carriage return or line feed 


Destructive space enabled 
ee ee ee 
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e 8 bits of data 
e Parity disabled 
e@ 2stop bits 


COMMUNICATIONS INTERFACE 


RS232 Considerations 


NICE uses RS232 for cormmunications. RS232 is a standard serial asynchronous 
protocol. However, NICE uses only those signals defined in the RS232 specifications 
that are necessary for its operation. While the typical voltage levels for RS232 are 
+12 and -12 volts, NICE uses +5 and 0 volts for the corresponding levels. 


WARNING YY 


The +12 and -12 volt signals from the terminal are 
clamped to +5 and 0 volts by diodes inside NICE. 
Since excessive current could damage the clamping 
diodes and/or custom circuits, be sure that you 
only use RS232 compatible devices with NICE. 
And never connect NICE to a device capable of 
supplying or sinking more than [5mA of current. 


Setting up the Communications Connector 


Before you configure the pins on the communication cable, determine whether you 
will be connecting via the Data Terminal End (OTE) or the Data Computer End 
(DCE). The DTE connection is the one most commonly used with NICE, Therefore, 
the cable provided is wired for connection to a terminal. 


The following list provides the pin numbers, signal names and functions for the 
communication cable connector provided with NICE, as well. To connect NICE 
directly to a computer, you must rewire the connector to conform to the pin 
numbers in parentheses. 


| PIN 3 (PIN 2): Received Data, sent from NICE to the CRT terminal. 


PIN 2 (P IN 3) Transmitted Data, sent to NICE by the CRT terminal. 


Nicolet 
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PIN 5 (PIN 4) - Clear to Send. This signal is sent by NICE to the terminal. A high 
signal (+5V) tells the terminal that NICE is ready to accept data. Use of PIN 5 


ensures that the terminal will not transmit at a rate faster than NICE can accept. 
PIN 20 (PIN 6) - Data Terminal Ready. This signal is sent to NICE by the terminal. 
A high signal tells NICE that the terminal is ready to accept data, Use of PIN 20 
ensures that NICE will not transmit data faster than the terminal can accept it. 

PIN 6 (PIN 20) - Data Set Ready. This signal is sent by NICE to the terminal. A 
high signal (+5V) tells the terminal that NICE has been installed and power has been 
applied to the target system. 

PIN 7 (PIN 7) - Ground, is the return path for the previous signals. 

INSTALLATION 

To install NICE: 


|. Remove the Z80 microprocessor from the target system. 


2. Connect NICE, using either the pin plug provided or the short 40 pin cable 


connector. 
e@ Whenever possible, use the pin plug. The pin plug reduces signal noise. Use 
the 40 pin cable only if you cannot physically attach NICE to the target 


system, 


e@ Se sure that pin | of the target systern is connected to pin | of NICE. 


Other wise, you may damage NICE's custom circuits, 


3. Attach the terminal to NICE using the communication cable provided. 


CHAPTER 3 
COMMAND LINE INTERPRETER 


COMMAND FORMAT 


Spaces -- NICE is controlled by simple one- to three-character commands entered 
at the terminal. Spaces are ignored, with one exception: a space must follow a 
command when the command is used with a parameter. Character data may be 


entered either in upper or lower case. 


Multiple Parameters -- When there are inultiple parameters in a command, the 


parameters must be separated either by commas or by spaces. 


Length -- The command line can contain a maximum of 31 characters. The 
terminal emits a beep once you have reached the 3l-character limit, Any additional 


characters typed after the beep replace the last character on the line. 


Execution -- NICE executes the commands on the command line when it receives a 


terminator character (Line Feed or Carriage Return) from the terminal. 


COMMAND PARAMETERS 


Certain commands require either alphabetic or numeric parameters, Numeric 
Parameters must be entered in hexadecimal form, they can be either an 8 bit or 16 
bit value, depending on the command. 


COMMAND LINE PROMPTS 


NICE displays two different Prompts depending on the success of the previous 
command. 


o The OK prompt (OK =>) indicates the previous command was executed 
Properly and that NICE is awaiting the next command. 


o The ERR prompt (ERR =>) indicates the Previous command was either entered 


incorrectly or its execution terminated abnormally. The ERR prompt is 


ne 
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displayed in conjunction with an audible warning. A new cormand may be 


entered following the arrow. 
MULTIPLE COMMANDS ON ONE LINE 


NIC= will execute several commands entered on the same line. Each command must 


be separated by a sernicolon. 
For example, the following command 
D E000; F 8000, 8800, AB 


causes NICE to execute the Display memory command followed by the Fill memory 


command, 
CONTROL CHARACTER FUNCTIONS 


Four control codes are used to aid in entering commands and control printout. To 


enter a control character, hold down the CTRL key as you hit the indicated letter. 


Table 3-1 
Control Characters and Their Functions 


=O 
6uaejee————soo—lTaOa——_—__—_— 


Choracter Function 
SS SS SS SS EE ee 
Ctrl-H Performs the same function as the backspace key: Back- 


spaces and deletes the previous character. 


Cirl-U Erases al! the previous characters on the command line and 
positions the cursor at the beginning of the cornmand line. 


Ctrl-S Starts or stops printout at the terminal. If printing, Ctrl-S 
stops the printing. If printing is already stopped, Ctrl-S or 
any other character causes printing to resume. 


Ctrl-C Aborts a printout or terminates a Repeat Line Command. 
For printouts, the abort takes place at the end of the next 
line of text. 
zz Nicolet 9 


REPEAT LINE COMMAND 


The Repeat Line Command (RL) instructs NICE to repeat the command(s) on that 
line over and over again. 


For example, the following command 
D £000; F 8000, 8800, AB; RL 


causes NICE to execute the Display me nory command and Fill memory command 


Over and over. 


NICE only ceases executing the commands on the command line when it receives a 


Ctrl-C from the terminal or when the target system is reset. 
COMPUTER INTERFACE TO THE COMMAND LINE INTERPRETER 


When you communicate with NICE using a computer instead of a terminal, NICE's 
response to ASCII characters is not always obvious. The responses which cannot be 


easily determined by viewing a CRT are listed below: 


Non-control characters are echoed exactly as received, 
Control characters are not echoed, 


Lower-case characters are converted to upper-case, 


You can terminate a command line with either a Line Feed or a Carriage 

Return. 

@ A Line Feed followed by a Carriage Return signifies that NICE is sending a 
new line. 

@ The response to a backspace (Ctrl-H) is the sequence Ctrl-H, space , Cirl- 
H. (Ona terminal, this sequence deletes one character.) 

e =A Ctrl-U causes NICE to respond with the sequence Ctrl-H, space, Ctrl-H 


the number of times necessary to backspace and delete the entire line, 
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CHAPTER 4 
OVERVIEW OF OPERATIONS 


GO MODE VS. QUIT MODE 

NICE has two different states of operation. 

In GO mode, NICE executes Z80 instructions at full speed, but only obeys a subset of 
its full repertoire of commands. NICL automatically enters the GO mode when you 


reset the target system. In QUIT mode, NICE obeys the full set of commands from 


the terminal, but it cannot execute instructions at full speed. 
Chapters 5 and 6 contain valid GO mode and QUIT mode commands. 


When you are not certain of NICE's current mode, you can issue the status command 
(ST) from either mode. If the bottom line of the display includes the word 
"RUNNING," NICE is in the GO mode. 


SPECIAL FACTS ABOUT NICE 


Because of NICE's compact new design, it behaves somewhat differently from larger 


emulators. 
Interrupts 


NIC& nas the capability of recognizing Z80 interrupts in the GO mode, but not in the 
QUIT mode. In GO mode, interrupts can be enabled or disabled from reaching the 


Z80 Microprocessor. 


Bus Requests 


NICE only recognizes Z80 us Requests when in the GO mode. In the GO mode, you 
can use one of the two GO mode commands to enable or disable Bus Requests to 
reach the Z30 Microprocessor. When NICE is in QUIT mode, Bus Requests are not 


allowed to reach the Z80 Microprocessor. 
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NOTE —— ¥ Reset Status 
If you use NICF in a systern that requires continu- 
ous access to the tnemory bus (such as a CRT 
controller), you should expect an under run condi- 
tion when NICE enters the QUIT mode. 


After reset, the following occur: 


e NICE comes up in the GO mode, appearing to the target system as if it 


were a Z80 microprocessor. 
Memory Refresh 


e@ The interrupt request and bus request lines are enabled. 
When NICE is in the QUIT mode, the Z80 control lines are cycled so that systems 
containing dynamic RAM will not lose data. The Refresh function is always enabled e All break point and print enable flags are cleared, 
following reset. However, you can use one of two commands to enable or disable 


this function. QUIT mode Refresh Timing Diagrams are provided in Appendix D. ® Saved memory address is set to zero. 


NOTE e Full speed execution starts at location zero. 
If the target system does not have dynamic RAM, 
it is a good idea to disable the Refresh function. 


Then, once NICE receives a carriage return from the terminal and sets its internal 
This allows NICE to operate 25% faster. 


baud rate, NICE enters the command line interpreter. 
Memory Requests 


When NICE is in the GO mode, memory requests are identical to Z80 memory 


requests. When NICE is in the QUIT mode, however, requests are extended. 


NOTE Tea 


The lines which control memory access with NICE 
in the target system are active for a longer period 
of time than they would be ordinarily. Therefore, 
during a memory read, be sure that data from the 
target system RAM remains valid for the entire 
period as indicated by the Z80 control lines. 


1/O Requests 


When NICE is in the QUIT mode, I/O control signals are extended beyond ordinary 
duration, As with memory requests, then, be sure that I/O read data remains valid 


for the duration as indicated by the Z80 control lines. 


ee ee 
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CHAPTER 5 BP - BREAK POINT 
GO MODE COMMANDS 
Purpose 
In the QUIT mode, NICE recognizes all commands. In the GO mode, however, NICE ; ; 
only recognizes a subset of these commands. The commands that NICE recognizes Sets any of the three break point addresses that work with either the Trace or 
in the GO mode follow: Untrace commands. Break points only work in QUIT mode. 
BP - Break Point Format 
BPC - Break Point Count 
EBP - Enable Break Point BP Break-Point-Number, Break-Point Address 
DBP - Disable Break Point : 
EPP - Enable Print Point Break-Point Number must be either |, 2, or 3, corresponding to the desired break 
DPP - Disable Print Point point. Break-Point-Address is a 16-bit value which NICE saves for later comparison 
El - Enable Interrupts to the Z80 program counter during Trace and Untrace commands, 
DI- Disable Interrupts 
EB- Enable Bus Examples 
DB - Disable Bus 
DR- Disable Refresh The following examples show how to set break point addresses and use the Status 
ER- Enable Refresh (ST) command to display the results. 
H - Hexadecimal Arithmetic 
Q- Quit rn] S===> Sy 
RL- Repeat Line ---> 9298 900 
---> Fags 8a D 
ST - Status ces Epes OB 
Z- Sleep IBR 
oO’ s===> BP 1 123 
Gi =sa==>: BP 2 456 
Ok ====) BP 3 739 
OK ====) ST 
---> 8123 96 D 
---)> 8456 88 D 
---> H789 66 D 
IBR 
DX ss==> 
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BPC - BREAK POINT COUNT 


Purpose 


Specifies the number of passes NICE makes before stopping at the selected break 
point, 


| lai NOTE 


Each of the three break points has its own one-byte 
Pass counter. Specifying a pass count allows NICE 
to trace a program past a particular address more 
than once before terminating with a break point. 


After NICE traces each instruction, it compares the enabled break point addresses 


to the program counter. If a match is found, NICE determines whether the pass 
counter is zero, 


e If the pass counter is zero, NICE stops tracing and sends the register display to 
the terminal. 


e If the pass counter does not read zero, then it is decre:nented and NICE 
continues tracing. 


Pass counters can also be used to determine the number of times a program passed a 


certain address. (NICE retains the decremented values even after it stops tracing.) 
Format 
BPC Break-Point-Number, Pass-Count 


The Break-Point Number must be either |, 2, or 3. The Pass-Count is a one-byte 
value, 
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Examples 


Qk sass ST 


---> 6123 880 
---)> 6436 08 D 
<<<) 8729 46 D 
IBR 


OK ====> BPE 1.11 
OK =s2=>) BPC 2,22 
OX sss=> BPC 3,33 
OK ====) ST 
<=> @123 31 0 
---)> 8456 22 0 
ser> Broo 33 
IBR 
ian sl 
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EBP - ENABLE BREAK POINT Examples 
Purpose oO e===) ST 
= : ---) 0123 11 D 
Enables one or all three break points. -=<) 9456 22 2D 
---) 8789 33 D 
Format IBR 
DE s===) EBP 
This command has two forms: OK ====) ST 
---> 2 E 
|. EBP - Enables all three break points. Zee ee i E 
---) 4789 33 E 
2. EBP Break-Point-Number - Enables break point |, 2, or 3, as specified. TBR 
ny ====) DBP 2 
DBP - DISABLE BREAK POINT Ok ====) ST 
---) 6123 11 E 
Purpose ---)> 6456 22 0 
--->) @789 337 E 
: ; IBR 
Disables one or all three break points. 
Qk sss=) 
Format 
This cormmand has two forms: 
|. DBP - Disables all three break points. 
2. DPB Break-Point-Number - Disables break point |, 2, or 3, as specified. 
f = Nicolet rz Nicolet 


EPP - ENABLE PRINT POINT 

Purpose 

Enables one or all of the three print points. Print points are used in combination 
with the Untrace Command to generate the register display. Enabling the print 
point function allows NICE to trace a large number of instructions while displaying 


the registers only at specific addresses. The registers are displayed when: 


®  aprint point is enabled, and 


® a match is made between the progran counter and the associated break point 
address. 


(eg ae NOTE Tinney 


The print point and break point functions are 
independent. The only similarity is that they both 
use the same address for comparison. 


Format 
There are two forms of the EPP commana: 
|, EPP - Enables all three print points. 


2. EPP Print-Point-Number - Enables the specified print point. 
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DPP - DISABLE PRINT POINT 


Purpose 


Disables one or all of the three print points. 


Format 


There are two forrns of the DPP command: 


|. DPP - Disables all three print points. 


2. DPP Print-Point-Number - Disables the specified print point. 


Examples 

0: ====) EPP 

OK ====)> ST 

mares) Plo S Vie ves he 
===) 0456 22 D0 P 
===> 7989 JIE P 
IBR 

Ox ====) OPP 1 


QK s=s==>) ST 
mem Biles 1h (& 
---)> 0456 22 DP 
=-=) 0769 33 E 
IBR 
OX sx2x=> 
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El - ENABLE INTERRUPTS 
Purpose 


Instructs NICE to allow hardware interrupts in GO mode if that capability has been 
disabled using the Disable Interrupts command. Interrupts are automatically 
enabled following reset of the target system. 


An"I" appears on the last line of the status display when interrupts are enabled. 


DI - DISABLE INTERRUPTS 
Purpose 


Instructs NICE to block interrupts so that they cannot reach the Z80 
Microprocessor. This function is useful for checking code since interrupts can be 
enabled or disabled during full-speed execution. If NICE did not have this 
capability, the alternative would be to disable interrupts in software. Not only does 
this method take time to compile the new object code, it corrupts the source. 
Further, it is not possible to disable the Z80 NMI interrupt in software. 
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Examples 

Ok ====> ST 
~--> 9123 11 
---> 0456 22 
---) 9789 33 
IBR 

OF s2=5> DT 

OK ====> $T 
=--} 6123 11 
---)> O456 22 
---> 0789 33 
.BR 

OK ssa): EI 
OK s=a=> ST 
=-—)> O23 11 
---) 8456 22 
---> 8789 33 
IBR 

Ok ====> 

zz Nicolet 


mom 


mom 


mom 


23 


EB - ENABLE BUS Examples 
Purpose 


Instructs NICE to allow bus requests in GO mode if that capability has been disabled =o) Mies te oe 
=s—> 8496 22 0 P 
E 


using the Disable Bus command. Bus requests are automatically enabled following =") Broo a7. 


reset of the target system. AB" appears on the last line of the status display when IBR 
the bus is enabled. Ok s===) DB 
OK ====) ST 
DB - DISABLE BUS 
——— Bes tae. 
---)> 8456 22 0 P 
Ni aa ---) B789 33 E 
LR 
Instructs NICE to block bus requests so that they do not reach the Z80 microproces- ov s===) EB 


sor. This function is useful for removing the asynchronous use of the address and 


data bus caused by DMA devices when you are checking a program. 


Sol tb Paes OES 
| 5 2 
; IBR 
The DB command can stop a data transfer before it 
is completed. With devices such as disk drives, it Qk ====) 


is possible that data contamination could result. 
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- REFRESH 
DR - DISABLE REFRESH BPs TSUN Ee 
Purpose Purt 
RS A : = Instructs NICE to allow memory refresh if it has been disabled. The refresh 
When NICE is in the QUIT mode, data is read every 1.25 msec from a minimum of 


‘ : : function is automatically enabled following system reset. An "R" appears on the 
128 consecutive memory addresses. This function maintains the dynamic memory 


: ; last line of the status display when memory refresh is enabled. 
refresh function. If your system does not contain dynamic RAM, you may disable 


the memory refresh function, allowing NICE commands to execute 25% faster. 
Examples 


OK esz2e> ST 


===> 8123 11 
---)> 8456 22 
---)> 8789 33 
IBR 


mom 
uv 


OK ====) OR 


-“--)> 6123 11 
---)> @456 22 
<--> 8789 33 
IB. 


OK sz=s=) ER 


mom 
D 


OK ====) ST 


mem B12 S, 1d 
---)> 8456 22 
---)> 8789 33 
IBR 


mom 
v 
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H - HEXADECIMAL ARITHMETIC 


Purpose 


Enables NICE to add and subtract 16-bit hexadecimal numbers. 


Format 


H First-Number, Second-Number 


After executing the command, NICE sends two values to the terminal: the sum of 


the two numbers appears first, followed by the difference of the two numbers. 


Examples 


OK ====) H 1808.45 
1045. 0FBB 

OF ====) H 4808, 1000 
5000. 3808 

O} ====) H FFFF.1 
8088, FFFE 
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Q- QUIT 


Purpose 


Causes NICE to leave the GO mode and enter the QUIT mode. When NICE enters 


the QUIT mode, the following occur: 

e Full speed execution of Z80 microprocessor is terminated. 
e = Interrupts and bus requests are inhibited. 

eA listing of current Z80 registers is sent to the CRT. 
Format 


Q 


Examples 


7 U.. A=@@ BC=81C1 DE=E25@ HL=E704 S=E8F4 P=E699 LOD A. 


S2HUNC A'=FF B'=FFFF D'=FFFF H'=FFFF X=FFFF Y=FFFF I=00 
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RL - REPEAT LINE 

Purpose 

Causes repeated execution of the command or commands currently on the command 
line. The RL command is especially useful when producing scope loops or looking 
for intermittent problems. 

Format 


RL must be the last command on the cormmand line. 


Examples 


OK ====) E FF 


OK ====) E FFiRL 


r= Nicolet 
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ST - STATUS 


Purpose 


Shows information about the following: 


e Break Points 

e =Print Points 

e = Interrupts 

@ Bus Requests 

e Refresh Function 
e GO or QUIT mode 


The first three lines of the status display represent the first, second, and third break 


points respectively. Each line reads like this: 


e The first entry represents the break point address. 

e@ The second entry shows the pass counter. 

@ The"E" or "D" indicates whether the break point is enabled or disabled. 

e A "P" indicates that the print point is enabled. A blank indicates that the print 
point is disabled, 


The fourth line of the status display shows the state of the interrupt, bus request, 
refresh functions, and whether NICE is in GO mode or QUIT mode. An |, B, or R 
indicates the function is enabled, while a period indicates the function is disabled. 


The word "RUNNING" indicates that NICE is in GO mode. 


cz Nicolet 31 


32 


=a S125 01 E 
===) 8496 ce DP 
==-?) 8789 33° E 
IBR RUNNING 


==> 
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Z - SLEEP 
Purpose 
Introduces delay into the comnmand line interpreter. 
Format 
Z Delay-Count 


Each count represents 1.25 ms of delay. Since Delay-Count is a 16-bit value, you 


can generate delays from |.25 ms to as long as 80 seconds. 


The Sleep command is most useful when used in combination with the Repeat Line 


command (RL) to produce scope loops. 
Example 
Below, the Z command is used with the RL command to read data from the I/O port 


Hex'FF.' The CRT update is slow enough to be viewed. 
OK #22) E FFiZz 188:RL 
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CHAPTER 6 
QUIT MODE COMMANDS 


In QUIT mode, NICE recognizes the following commands: 


As 
D- 
fs 
F - 
Gu 
Be 
M= 


MT - 


Om 
R- 
he 


Assemble into RAM 
Display Memory 
Examine Input Port 
Fill 

Go 

List in Assembler Format 
Move 

Memory Test 

Output 

Read Intel Hex File 
Substitute Into Memory 


SR - Soft Reset 


el - 
eU- 
Vie 
Se 


Trace 
Untrace 
Verify 


Xamine 


~Gr CLEAR Be tPA 
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A - ASSEMBLE INTO RAM 


Purpose 


Allows you to enter Z80 assembly language at the terminal. Each line is compiled as 


it is entered; the result is placed in the target system RAM. 


Format 


Two forms of the command are allowed: 


|. A - Begins placing the assembled code at the currently saved memory address. 
The new saved memory address becomes one more than the last byte used in the 


assembly process. 


2. A Start-Address - Begins placing the assembled code at the specified memory 


address. 


Once you enter the command, the terrninal displays the memory address which will 
receive the first byte of the assembled code. Following the memory address, you 
enter the desired Z80 assembly language mnemonics and a carriage return. NICE 
assembles the instruction, places it in memory, and displays the address of the next 


instruction, 


If an error in assembly is detected, the address is displayed again so that you can re- 
enter the instruction. This process repeats until you enter a blank. At that time, 
NICE returns to the OK prompt. 
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Examples D - DISPLAY MEMORY 
Purpose 
OK ===) A 8eee 
8008 LD A.68 4 Displays the contents of the target systern's memory space. 
8ee2 LO BC. ee8a 
8885 INC A ry 
8006 INC B Format 
8907 CP 48 
8809 JR NZ. 8805 
8@@B LD B. 68 Each line of the display begins with the address of the first byte, followed by sixteen 
phd JR 8885 bytes of data in hexadecimal form. The same sixteen bytes in ASCII form end the 
ne ‘ line. If no ASCII character exists for the corresponding byte, then a period is listed, 


There are three formats for the Display Memory command: 


|. D - Displays memory from the currently saved memory address through the 
next eight lines (128 bytes). Because the saved memory address is always one 
more than the last memory address, using a series of D commands displays 


t successive blocks of eight lines of data, 
{ The saved address is set to zero following reset. 


2. D Start-Address - Displays eight lines of data beginning with the specified 
Start-Address, 


3. D Start-Address, Last-Address - Displays the block of data within the specified 
range. 


ee ee ee eee 
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Examples 

OK ====> D E88e@ 

Eeee8 C3 OF E@ C3 13 E@ C3 32-E@ C3 39 EO CI 2DEC AF ........ Boe 
E016 C3 15 E@ 3E 8@ 32 49 E8-37 OF FA 1E E@ C7? 31 B@ Sees ee | 
£628 E9 21 28 E@ ES CD EF E6-C3 B4 E@ 1A EB 3E FF C3 PRs sists aie : 
E@3@8 41 E@ 32 4E E8 AF C3 3E-E@ 32 4E ES SE 88 32 49 A. 2N a ENS. 21 
£n4e@ E8 22 4A E8 21 88 88 39-31 88 E9 E5 05 C5 3C C2 BAY Jie NEE ) OS Bieter < 
Eese 58 €@ CD EF E6 C3 76 E@-21 28 ES 35 F2 7B EB 34 Meanie Mad cone’ 
Ea6e8 CO B9 E6 CA BB E@ 3D CA-89 E@ 30 CA AB E@ 3D CA ...... Mone Mice aes 
£078 94 E@ 30 CA 9A EB ZE B1-C3 29 E4 CD 58 E6 23 46 Be de PME 
OK s=22)> D 

Ease 3A 4E E8 77 2B 78 C3 76-E@ 36 @2 78 E6 OF 32 21 N.vte v.6.x..2! 
Eee E8 C3 76 E@ 11 8@ 7F C3-AZ E@ 11 88 7F C3 AZ EB ei Wiccaletunmeeurcace oye 
Ee@Ae 11 7F 86 73 CD 8B E6 FA-76 E@ CD EC ES C3 AZ E@ see Miere etki Wis, Piste acme 
E@Be 78 32 21 E8 21 83 14 22-47 E8 31 FA E8 CD 58 £6 ba) pad Pd ey fee 
Eece SE 23 56 EB 23 22 4C E8-36 O82 2B 11 4E E8 BE 07 a#U #°L.6.4.N.. 
Eeoe CD 82 E6 CD B9 E6 47 BE-C1 21 E2 E? 7E B7 CA IE ! 

EeE@ E4 23 SE 23 S56 23 @5 F2-0C E@ @7 DA 1E E4 OS FS is 
Eara 3A 4E E8 CD 8B E6 FA 28-E4 C2 IF E4 3A 49 E8 87 I 
OK ====)> D E@08.E@IF 

£ae C3 OF E@ C3 13 E@ C3 32-E@ C3 39 E@ CZ QDEP@ AF ........ - 
£418 C3 15 E@ 3E 8@ 32 49 E8-37 SF FA 1E E@ C7 31 aa 2.21.2. 1 
OK ====) 
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E - EXAMINE INPUT PORT 


Purpose 


Retrieves data from a given I/O port and displays the 8-bit hexadecimal result. The 


specified Port Address must be an 8-bit number. 


Format 


E Port-Address 


Examples 
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F-FILL 


Purpose 


Loads a block of target system RAM with a given 8-bit constant. A good use of this 


command is to clear target system RAM prior to debugging code. 


Format 


F Start-Address, Last-Address, 8-Bit-Value 


Examples 
OK ===>) F 3800,8880,AB 
OK ====> 0 3008 


8eea AB AB AB AB AB AB AB AB-AB AB AB AB AB AB AB AB 
3ai1a AB AB AB AB AB AB AB AB-AB AB AB AB AB AB AB AB 
8628 AB AB AB AB AB AB AB AB-AB AB AB AB AB AB AB AB 
8838 AB AB AB AB AB AB AB AB-AB AB AB AB AB AB AB AB 


OK ====) 0 38a8 
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Purpose 

Instructs NICE to enter the GO mode and start the target system running at full 
speed. 

Format 


There are two formats of the GO Command, as shown below: 


|. G - Full speed execution begins at the address contained in the program 


counter. 


2. G Start-Address - F ull speed execution begins at the specified address. 


EXECUTION BEGINS AT ===> E687 
OK ====) 0 


HH... A=@@ BC=88A1 DE=10@E HL=EAGA S=E8F4 P=ESEB MCP I=B: 
SZHUNS @'=7F B'=7FFF D'=FFFF H‘=FFFF X=F9AB Y=FBDF 1=08 


OK ====) @ Eeen 
EXECUTION BEGINS AT ===) Eee 


cz Nicolet 4l 


2. L Start-Address - Lists the block of 19 instructions be 


Sones Start-Address, Last-Address - 
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L - LIST IN ASSEMBLER FORMAT 
Purpose 


Disassembles instructions in the target system memory into assembly language 
format. 


Format 
Three forms of the command are illustrated: 


|. L-Disassembles 19 consecutive Z80 instructions, beginning with the currently 


As each instruction is disassembled, the new saved 
memory address points to the start of the next instruction. Thus, repeated L 
commands in this form list sequential blocks of 19 instructions. 


saved memory address. 


ginning with the specified 
Start-Address, 


Lists the block of instructions beginning with 
the specified start address and ending with the specified last address. 


c= Nicolet 


Examples 


OK ===) L 9900 


8aag 
8aa2 
sees 
8eu6 
8ea? 
8ee9 
8eaB 
8800 
8OGE 
Sear 
sala 
8811 


LO A. 8e 

LO BC, e888 
INC A 

INC B 

CP 4a 

JR N2, 8885 
LO B. ee 

JR 8885 
NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 

NOP 
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M - MOVE MT-MEMORY TEST 


Purpose Purpose 


Verifies that the target system RAM is functioning properly. 


NOTE aa 


Format 

The test used is sometimes called the "peaks and 
valleys test." First it tests the RAM by walking a 
M Start-Address, Last-Address, Destination-Address one through each bit; then it walks a zero through 
each bit. The process is to write the particular 
pattern throughout the entire range and then go 
Examples back and check each byte to see that it matches 
the pattern written. NICE repeats the process for 

each of the 16 patterns. 


Copies a block of target system memory froin one location to another. The source 


data may be in ROM or RAM, but the destination must be in RAM, 


OK ====> 8888. 83908,08 
OK ====) M Eee0.EB1F.3800 i 
ite The MT Command takes approximately I5 seconds for each IK of memory. 
OK ====) D Eaee Therefore, you may want to start by checking small blocks of memory. 
Euae C3 OF E@ C3 13 EB C3 32-E@ CI 39 EB C3 20 EG AF aks eee 
EB1@ C3 15 E@ 3E 30 32 49 E8-37 9F FA 1E £8 C? 31 88 >. 21.7 fi 
£828 E9 21 2B E@ ES CD EF E6-C3 84 EB 1A E@ SE FF C3 + > Format 
Fase 41 EO 32 4E ES AF C3 SE-E@ 32 4E ES JE 88 32 49 A.2N RON: Pr2t 
es ee s ES 21 08 88 39-31 @@ E9 ES O5 CS 3C c2 AWD, GOT cont 
a5 58 E@ CD EF £6 C3 76 EO-21 20 £8 35 F2 7B EB 34 X vil 5.4.4 - = 
Ea6e CO 89 E6 CA BB E@ 30 CA-89 EA 3D CA AB EW 30 CA = =) ie. eae Ce rer ete en 
Fa7e 94 £8 3D CA 9A E@ SE 81-C3 29 E4 CD S@ EG 23 46 a yi. -o PL RF 
Ok ====) 0 seee 
oaee8 C3 OF E@ CZ 13 E@ C3 32-E@ C3 39 EB C3 20 EB AF rhe 
8a1e8 C3 15 E@ 3E 88 32 49 E8-37 SF FA 1E Ea CP? 31 Oe aT ar. 1 
8826 @8 88 88 86 BA BA BG BB-H8 24 BG BO BA BB BB BR 
8838 68 68 G8 88 88 84 OG G8-08 BA GA BA BA 8G 2B Be 
cade 66 88 88 88 BO G6 BA BB-88 HB BA OB Be BB BA BA 
8850 68 88 G8 88 84 88 BA 88-88 BA BA BE BA BB BO BB 
8860 68 88 GG 48 8G BG BG BA-88 BA BG OG Be GA 48 Ba 
8a; 88 88 GB OA 8G OA BA BA-B8 88 BA BO BA BO BB BA 
UK s2=2) 
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Examples 


OK ====) MT saaa,380a0 
OK ====) MT 9888.Aga0 
OK ====)> MT B8e8,ce00 


C888 ---> B1/FF - WR 
C@Q@ ---> O2/FF - WR 
C@Q@ ---> O4/FF - 
C@Q9 ---> B8/FF - WR 
COQ8 ---> 18/FF - 

COQ9 ---> 20/FF - WR 
CBGB ---) 40/FF - WR 
C88 ---> 8O-FF - WR 


COQ ---) FE/FF - WR 
C@Q8 ---> FD’FF - WR 
COG@ ---> FB/FF - WR 
C@@G@ ---)> F7/FF - W/R 
C@@@ ---> EF/FF -— W/R 
COG@ ---> DF/FF - WeR 
C@G@ ---> BF/FF - WR 
C@Q@ ---> 7F/FF - WR 
OK ss==> 

46 
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O - OUTPUT 


Purpose 


Sends one or more 8-bit data bytes to an I/O port. 
Format 
O Port-Address, |/O-Data, I/O-Data, ... 


The Port-Address and the |/O-Data are 8-bit values. You must supply the Port- 
Address and at least one |/O-Data byte. Any additional |/O-Data bytes, if provided, 
will also be sent to the I/O port. Sending multiple data bytes to an I/O port is 
especially useful with sorne of the newer LSI chips such as CRT, DMA and F loppy 


Disk controllers. 


Examples 

OK ====) 0 FF.1A 

OX ====) O FF.1A,1B.10,10.1E 
OK ====> 
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R - READ INTEL HEX FILE 


Purpose 


Loads an Intel Hex file into the target system RAM, 
Format 


A description of the format for an Intel Hex file is given in Appendix B. Two forms 


of the command are allowed: 


I. R - Loads the file directly into RAM at the location indicated by the Intel Hex 


file, 


2. R Offset - Adds the 16-bit offset value to the destination address prior to 
loading the data into RAM, The last record of an Intel Hex file specifies the 
Program counter address and the offset is applied to this value as well. This 


form is useful for downloading relocatable code. 


Once you enter the command, NICE only recognizes input which corresponds to an 
Intel Hex file. Each record begins with a colon (:), so NICE looks for a colon at the 
beginning of each record and ignores all other characters. This reduces NICE's 
susceptibility to noise and allows you to switch to a different download device 
following entry of the R command. As with the command line interpreter, all non- 
control characters are reflected as they are received. Thus, you can confirm that 


NICE received the correct sequence of characters. 


NICE exits the command only at the end of the Hex file or when an error is 
detected. 
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NICE responds differently to good records and bad records: 


e If the record is good, NICE sends this sequence: 
ACK,LF,CR 


e If the record is bad, NICE sends this sequence: 
NAK, xx-ERR,LF,CR 


xx stands for RT (Record Type error), CS (Check Sum error), or HC (invalid 
Hex Code). 


The Intel Hex file is composed of records. NICE processes each record as it is read. 


This means that NICE stores data in the record as it is received. 


NOTE 


When an error occurs, bad data may be stored in 
the target system RAM. To remove the bad data 
and continue downloading the file, issue another 
Read Intel Hex File Command, Begin downloading 
the file with the record that caused the error. 
Because each printable ASCII character is echoed 
as it is received, you may check that each char- 
acter has been received properly by NICE. 
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Examples 


OK ====) R 
OF 88BGGG3E 888 | ABBAICO4FE4O20F AB6OB1 BF E86 
88888001 7F 


OK! ===) 


. A=88 BC=e08e OE=8008 HL=8080 
. A'=0@ B'=9808 D'=ee08 H'=8008 


see 3E 88 G1 88 88 3C 84 FE-48 28 FA 
8018 88 88 G8 88 88 GB BB BG-80 BG BE 
8828 6G 68 68 88 8G BO BB BB-88 86 BG 
8638 88 88 88 BG 4B BA BA BE-B8 BB BA 
8948 88 88 86 68 88 88 BA B6-86 B80 BA 
$858 868 68 88 88 88 88 BB BA-88 BB Ba 
8ea6e G8 88 88 88 66 88 BB 88-88 BG 4B 
8078 88 68 88 BB 8G BA BB BA-BO BE 48 


OK ====) R 188 
 BF8B88883E 888 1 ABVAICU4FE4O2GF AG6BO1 BFE8E 
* 88888001 7F 


OK ==25> % 


S=ee08 P=3880 
xX=80806 Y=0008 


A=68@ BC=800e@ DE=9008 HL=09ee@ S=8008 P=31808 
x=6088 Y=0000 


aie A'=8@ B'=8808 0'=9088 H'=0808 


8188 3E 88 81 80 GA 3C 84 FE-4@ 28 FA 
$118 88 88 68 68 88 BA 88 88-20 88 28 
8128 88 88 88 88 BB 88 B@ BB-88 BB 48 
8138 88 68 68 88 88 BG 6A 6-08 80 08 
8148 68 86 88 88 6G G6 BBO 88-286 86 Be 
8158 88 88 68 88 88 86 BG Be-88 BA BA 
86a 68 88 88 88 BG BB 86 86-86 26 2A 


8178  @8 8@ aa Ba 48 2a Be AG-2e Be BO 
OK ====) R 

:BF8aaeas RT-ERR 

ERR ===) 
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LO 4,68 
I=8@ 


LD A.88 
I=066 


cz Nicolet 


—_—_—$—$—$—$—$—$————————— OO esr _ ———_ ee  —_— TT 


S - SUBSTITUTE INTO MEMORY 
Purpose 
Allows you to view and optionally enter data into the target system RAM, 


Format 


2. S Start-Address - Starts at the specified address. 


Once the process is started, the terminal displays the data at the current address, 
At that point you may enter any of the following: 


|. A single carrige return. In this case the data at the associated address remains 
unchanged, the current address is incremented, and the next data is byte 


displayed, 


2. New data to replace the current data followed by a carriage return. The 


current address is then incremented and the next byte displayed. 


3. A"-" followed by a carriage return. This form is used to back up to a previous 
location and correct an error. The data at the current address is left 
unchanged. The current address is decremnented and the previous byte is 
displayed. At that point, you may type any of the options in this list. 


4. A"." followed by a carriage return. This ends the substitute process and causes 


NICE to return to the command line interpreter. 


cz Nicolet 51 


Examples 


OK ====> S$ 38F8 


88F8 7F ---> 
SOF9 7F ---> 
88FA 7F ---) 
80FB 7F ---> 
83FC 7F ---> 
80FD 2F ---> 
80FE 7F ---> 
8OFF 7F ---) 


8108 3E ---> 3E 
8181 7F ---> 6é 
8182 7F ---> @1 
8183 7F ---> 8B 
8184 7F ---)> ab 
6185S 7F ---> 3C 
8186 7?F ---> 84 
8107 7F ---)> FE 
8108 7F ---> 99 
8189 7F ===> - 
3188 99 ---> 48 
8189 7F ---> 28 
818A 7F ---)> FA 
810B 7F ---> 86 
818C 7F ---> 
8100 7F ---> 18 


Sure ri UA err A and coed ag'd Dae d Soa’ d Sand awd SOPd et ed dat d rd Go 
8188 3E 80 61 88 88 3C G4 FE-48@ 28 FA B86 7F 18 FE 7F > = eH 2 
8118 CDA dd Seed lit dd Ed a idk d Did Sah Derk Oe dee dd DAY f Qe ee 
8128 fF CE CE OTF CE TE CF PR =PF PE PR PR CE PE PEO i ec dca os 
8138 DR OR TE CE, ERLE! RE: TEAS ES PESTER REE TEEROIER: a mp iceicsis cy wa ison 
8148 th Ck CE PE ee VE te PERCE LEO PE PCR CE TERR 2 oncwauescte cca 
8158 YA Sted ind Zed aad iad oa A Died ad ef dd cl Te d ae dc 4 J 
8168 CP ACER: CE RE CEO TE ERE. PE TER PE TE TR RPGR Coes ccd ey scone 
OK #===) 
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SR - SOFT RESET 


Purpose 


Clears all the Z80 registers and flags so that they read zero. 


This command is 


especiclly helpful for tracing code; it is easier to see when registers are changed by 


the various instructions. 


Examples 

Ue Eee 
S...<:6 A=FG 
SZHUNC A'=FF 
OK ====> SR 
OX s===)> X 
Haase os A=68 
gunPale ate A'=88 
OK ====)> 


BC=0900 
B'=FFFF 


8c=8808 
B'=8888 


DE=1000 
0'=FFFF 


DE=08068 
O'=8eee8 


HL=828@ S=ESFC P=E719 RRA 
H'=FFFF X=FFFF Y=FFFF [=80 
HL=8080 $=0800 P=8008 RST 38 
H'=9@a0 X=9000 Y=0000 I=00 


ee ne a es ee 
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Dee ee 


e! - TRACE 


Examples 
Purpose OK ====> X P 
P=ee0e8 ---> E888 
Allows you to follow a program through one or more instruction steps. After each — 
QK ====)> } 
instruction is executed, NICE displays all internal 780 registers and flags, as well as ; geee S=eaea P=Ea0a JP coer 
me n=, = HL= $= = 
the mnemonic of the next instruction. The Trace Command is especially useful in peak Pits a cones recess igen X=0088 Y=e8ea I=00 
debugging virgin code. 
OK -222=>: T 
= r=aga@ OE=900@ HL=aee@ S=8808 P=EBBF XOR A 
Format Sts eee Fah! ee =p000 D'=8@e@a H'=0aee xX=0000 Y=0800 I=80 
NK zx=e=ss)> T 5 
The Trace Command has two formats: si 


7 =90 BC=0000 DE=e00@ HL=9909 S=e00@ P=E010 JP £015 
Fikes gone B'=@90@ D'=9000 H'=9900 X=e088 Y=8e80 I=00 
|. »I - Traces the program through one instruction. 


_Z.U.. A=@@ BC=000@ DE=ee@88 HL=000@ S=008@ P=EB15 LD (E849).A 


Saat A'=8@ B'=0900@ D'=eeae H'=a00e0 xX=e008 Y=8008 I=08 
2. «1 Number-of-Instructions - Traces the program for the specified number of 


= = =980@ P=E@18 SCF 
.2.U.. 9=0@ BC=ee0@ DE=88008 HL=0800 S=88 = : 
instructions. (Number-of-Instructions is a 16-bit value.) a'=aa R'=9000 D'=900@ H'=e9e0 X=0008 Y=0000 [=a0 
.2.U.C A=88 BC=8008 DE=8008 ep fone avs ri A 
After NICE traces each instruction, all the Z80 registers and flags are printed at the ‘ ...... A'=08 B'=9008 D'=8008 H'= 


terminal. If break points are enabled, encountering a break point will cause the S.H.NC A=FF BC=e800 DE=e08@8 HL=e98@ S=8080 P=EB1A JP M.EGIE 


A'=@a@ B'=9800 0'=9008 H'=e88e X=a008 Y=e008 I=00 
trace sequence to terminate, ; 
OK szs=) 
You can start or stop printout by entering CTRL-S, or terminate the command by 
entering CTRL-C,. 


CAUTION: USE OF THE T CommAvd | a 
wiTHouT THE e (oor) MAY eet fees 
i dEesTrRuerion of dATA iw A Cedi 


ee 
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e U- UNTRACE 
Purpose 


The Untrace Command is identical to the Trace Command except that the Z80 
registers and flags are printed only when the last instruction is traced. It allows you 


to trace a large number of instructions without having to wait for the printout at 
the terminal. 


Format 
The Untrace Command has two forms: 
!. @U - Traces the program through one instruction. 


2. e U Number-of-Instructions - Traces the program for the specified number of 
instructions. (Number-of-Instructions is a 16-bit value.) 


Enabled break points cause the Untrace Command to terminate and the display to be 
generated. Enabled print points are displayed but do not terminate the command. 
When the command terminates, the addresses of the previous four instructions are 


displayed, These are referred to as backtrace addresses - |, -2, -3, and -4, 


CAUTION, USE OF THE i guesgas op 
wiITHoT THE e« Cdo7) MAY 7 ESUET + = 
CESsTRUCTIOW OF d87TA 1h) A eonThie RECSTER 
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Examples 

Ok #2==) STR 

EXR ===) ST 

==> @123 11 E 
---) 6456 22 DP 
~--) 6789 33 E 
IBR 

OK ====) SR 

OK ====> X P 


P=8086 ---> Eeee 


OK ====> U 
ACK TRACE  ------ > -4=@e00 -3=9000 -2=9000 -1=E9a0 
wae RC=9008 DE=0080 HL=9900 S=8aaa P=EBGF XOR A 
 "" ptaga B'=a0@@ D'=0000 H'=Ga0a xX=0000 Y=ea00 I=00 
OK ====) U 188 
ack ji Sees > -4=E6DA -3=E6D0 -2=E6DE -1=E6DF . 
— Cree ee BC=0900 DE=1988 HL=E9@2 S=E9FA P=E6E@ LD CHL).D 
" g'sa@ B'=9008 D'=Ga0a@ H'=0000 x=a000 Y=9a0a I=00 
OK ====) U 1801 
K TRACE =--=== > -4=6683 -3=E684 -2=E685 -1=E686 
BOE tee BC=0808 DE=ES1E HL=E75@ S=E9FA P=E687 JP NZ. E682 
g'=aa B'=9008 D'=0908 H'=a0aa X=0a0@ Y=900a I-08 
OK ====; 
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V - VERIFY Examples 


Purpose 
OK ====> F 3008,98008.08 
Compares two blocks of memory within the target sytem and indicates any BR aes MERU ETmne SER 
differences, OK ====)> D Ege 
£9088 C3 OF E@ C3 13 E@ C3 32-FE@ C3 39 EB CI 2D EB AF ....... Pot en Se 
= Ente C3 15 E@ 3E 8@ 32 49 E8-37 OF FA 1E E@ C7 31 88 Ed EE eS 
ormat E928 E9 21 2B E@ ES CD EF E6-C3 B4 E@ 1A E@ JE FF C3 BS eee oe ae are 
Ea3e 41 E@ 32 4E ES AF C3 JE-E@ 32 4E E8 JE 88 32 49 A.2N...>.2N.>.21 
£448 E8 22 - nH 21 6@ 8@ 39-31 6@ E9 ES 05 cS 3C C2 aS BO ae 5 MRE ern ¢ 
= + Ease 58 £@C E6 C3 76 E@-21 20 E8 35 F2 78 E@ 34 RisiesVal sects 
V Start-Address, Last-Address, Compare-Address £e6@ CD 89 £6 CA BO £8 30 CA-389 F830 CAABEA@IDCA Ot a oe 
£87@ 94 E@ 30 CA 9A E@ ZE B1-C3 29 E4 CD 5@ E6 23 46 ceeded PF 
Each of the parameters are 16-bit addresses. The Start-Address and Last-Address OK sass? 08808 
define one of the two blocks of memory as well as the length of both blocks. 8ue@ C3 OF E@ C3 13 E@ CZ 32-E@ C3 39 EO CS 2D EC AFC... Bateau 
Com Address is-th - F oa1e C3 15 E@ 3E 86 32 49 E8-37 OF FA 1E E@ C7? 31 BA see ruse 1 
pare-Address is the starting point of the second block of memory. If there is a £828 E9 21 28 £@ ES CD EF E6-C3 B4 EG 1A E@ 3E FF C3 aS See Dy 
isc . ‘ P é 4 ~ SON ot DON OL e 
discrepancy between the data at equivalent locations in the first and second blocks, eaae ts 32 4a és 21 30 b8 39-51 36 és ES os ts 3 t2 ari “31 Ss re 
NICE prints the address within the first block, the data at that address, and then the ie re As oy A ae oe fe ee a oo re fe te S 8 aka a : e ae 
data within the second block. 8678 94 E@ 30 CA 9A EB ZE G1-C3 29 E4 CD 5@ E6 23 46 Ses Peewee: 
OK ====> $ 3848 
$340 E8 ---> 08 
Ses) 22°===)) = 
OK ====> UV £008.E7FF.93808 


E48 ---> E8 @8 
OK 


as=5): 
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X - XAMINE 


The Xamine Command has two forms as indicated below: 


X - Causes all the Z80 registers and flags to be displayed at the terminal. 


Both the primary and secondary sets of registers are displayed, the primary set 
on the top line and the secondary set on the bottom line. 


The two flag registers are displayed as a series of letters where each character 


represents one bit of the register. The letters represent the various flag bits as 
indicated below: 


S- Sign Flag 

Z- ZeroFlag 

H- Half Carry Flag 

U- Parity or Overflow Flag 
N-  Add/Subtract Flag 

C- Carry Flag 


The appropriate character is printed when the bit is set and a period is printed 


when the bit is reset. For example, if the Sign and Carry bits were the only 
ones set, the display would read; 


Seve 


X Red-Id - Displays and allows modification of the internal Z80 registers. Reg- 


Id indicates the desired register, and may be any of the following: F,F', A, A’, 
8; Bi. bs:S,.P,X, Yor 1. 


After the data in the register is displayed, you may enter a carriage return to 
retain the old data, or you may enter new data to replace the old. If you enter 
new data, enter a one byte value for a one byte register and a two byte value 


for a two byte register. If you enter no data, the register rernains unchanged. 


tz Nicolet 


Examples 
OK ====)> N 
N. A=7F BC=9008 
A'=88 B'=e000 
OK ====> SR 
OK ===) X 
A=86 BC=H9888 
A'=8@ B'=8808 
OK ====) XP 


OK ze==) X'S 
$=@888 ---> 
OK ====) X 


A=08 BC=0008 
A'=80 B'=0008 


OK ====) % F 
Tee ---)> HCY 
OK se==) x 
HU.C A=88 BC=88900 


a‘'=88@ B'=8800 


Qk ====> 


DE=ES1E 
0'=e888 


DE=8980e4 
O0'=80e88 


O£&=8eae 
0‘'=888e 


OE=8888 
0'=89a8 


HL=E758 
H'=8886 


HL=8808 
H'=8088 


HL=8688 
H'=1234 


HL=0008 
H'=1234 


$=9008 
xX=8008 


$=9888 
x=00088 


P=E687 
y=ea08 


P=8808 
y=9e08 


P=E688 
y¥=0ga8 


P=E088 
y=o008 


JP NZ.E682 


JP E@GF 
1=88 


JP E@GF 
1=68 
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A sa 


D sa, la 


E pa 


F sa, la, d8 


Gsa 
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APPENDIX A 
QUICK REFERENCE COMMAND LIST 


Quit Mode Only 


Assemble into memory beginning at the last referenced 


memory address, 


Assemble into memory beginning at the specified start 


address (sa), 


Display the block of mernory beginning at the last refer- 


enced memory address. 


Display the block of memory beginning at the specified start 


address (sa). 


Display the block of memory beginning at the specified start 
address (sa) and stopping at the specified last address (la). 


Examine the data at an I/O port address (pa), 
Fill memory from the specified starting address (sa) up to 
and including the specified last addess (la) with the specified 


8 bit data byte (d8), 


Go into full speed execution starting at the current program 


counter location, 


Go into full speed execution starting at the specified start 


address (sa). 


List in assembler mnernonics beginning at the last 


referenced me:nory address. 
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L sa 


M sa, la, da 


MT sa, la 


O pa, d8, d8, ... 


R off 


S sa 


SR 
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Quit Mode Only (continued) 


List in assembler mnernonics beginning at the specified 


start address (sa). 


Move the block of memory between the specified start 


address and the last address to a destination address (da). 


Run a memory test on the target system RAM between the 


specified start address (sa) and a last address (la). 


Output to the specified port address (pa) one or more 8 bit 
data bytes. 


Read an Intel hex file and load the data into the target 
system RAM. 


Read an Intel hex file, applying the specified 16 bit offset 
value prior to loading the target system RAM. 


Substitute into memory beginning at the given start address 


(sa). 


Do a soft reset of the Z80 microprocessor to clear all 


internal registers and flags. 
Trace one instruction. 
Trace one or more instructions. 


Untrace one or more instructions. 
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Quit Mode Only (continued) 


V sa, la, da Verify that the target system memory is the same beginning 
at a given start address (sa) and ending at the last address 
(la) to the data block Starting at the destination address 
(da), 
x Display all the Z80 internal registers and flags. 
X? Display and allow modification of the specified Z80 internal 
registers. ? can be any one of the given registers: 
ere 
? = F,F',A,A’,B, BI, D, D', H, H', S,P, X, Y, | 
és c= Nicolet 


BP I, dlé 
BP 2, dlé 
BP 3, dl6é 


BPC I, d8 


BPC 2, d8 


DPP n 
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Go or QUIT Mode 
Set break point address | to the specified 16 bit value (d16). 
Set break point address 2 to the specified 16 bit value (d16). 
Set break point address 3 to the specified 16 bit value (d16). 


Set break point pass counter | to the specified 8 bit value 
(d8). 


Set break point pass counter 2 to the specified 8 bit value 
(d8). 


Set break point pass counter 3 to the specified 8 bit value 
b ; ~Ayar5 

ere Act BEAL Pus PRT FOIA 

Enable all three break points. 


Enable break point |, 2, or 3 where (n) is the break point 


number. 
Disable all three break points. 


Disable break point |, 2, or 3 where (n) is the break point 


number. 
Enable all print points. 


Enable print point |, 2, or 3 where (n) is the print point 


number. 
Disable all print points, 


Disable print point |, 2, or 3 where (n) is the print point 


number. 
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Go or QUIT Mode (continued) 


El Enable interrupts to be received by the Z80 fron the target 
system. 

DI Disable interrupts from the target system. 

EB Enable bus requests to be received from the target system, 

DB Disable bus requests from the target system. 

ER Enable NICE's automatic refresh function. 

DR Disable NICE's automatic refresh function. 

H dl6, dlé Using hex arithmetic, calculate the sum and difference of 


the two specified 16 bit data values. 


Q Quit full speed execution. 

RL Repeat the given command Jine in order to provide a scope 
loop. 

ST Display the ernulator status, including 


break point addresses 

pass counters 

break point enable or disable 
print point enable or disable 
interrupts enable or disable 
bus requests enable or disable 
refresh enable or disable 


emulator tnode 
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APPENDIX B 
INTEL HEX FORMAT 


A short Intel Hex File is shown below: :02319300923176 
:00310001CE 


Explanations of each field follow: 

Record Mark Field: Frarne 0 : 023193009231 76 
The ASCII code for Colon (:) is used to signal the start of a record. 
Record Length Field: Frames | and 2 : 023193009231 76 


The number of data bytes in the record is represented by two ASCII hexadecimal 
digits in this field. The high-order digit is in frame |. The maximum number of 
data bytes in a record is 255 (FF in dexadecimal). Two ASCII zeroes in this field 


indicate an end-of-file. 


Regardless of the record type, a zero record length causes NICE to return to the 


command line interpreter following receipt of the checksum field. 


Load Address Field: Frames 3-6 :02 3193 00923176 

The four ASCII hexadecimal digits in frames 3-6 give the address at which the data 
is loaded. The high-order digit is in frame 3; the low-order digit is in frame 6, The 
first data byte is stored in the location indicated by the load address; successive 
bytes are stored in successive memory locations. This field in an end-of-file record 


contains zeros or the starting address of program. 


Zdl6 Have the emulator wait a given amount of time before 
executing the next command. (Good for scope loops) 
ss c Nicolet 
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Record Type Field: Frames 7 and 8 2023193 00 923176 


The two ASCII hexadecimal digits in this field specify the record type. The high- 
order digit is in frame 7. All data records are type 0; end-of-file records are type 0 
or |. Other values for this field are not recognized and will cause an error in the 
downloading process. 


Data Field: Frames 9 to 9+ 2* (record length - |) :02319300 923176 

A data byte is represented by two frames containing the ASCII characters 0-9 or A- 
F, which represent a hexadecimal value between 0 and FF (0 to 255). The high order 
digit is in the first frame of each pair. There are no data bytes in an end-of file 
record. 


Checksum Field: Frames 9 + 2* (record length) to 9 + 2* (record length + |) 


2023193009231 76 
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APPENDIX C 
TARGET SYSTEM MODIFICATIONS 


CROMEMCO ZPU 


The ZPU card causes the data bus from the systern RAM to be disabled for two or 
three cycles following the leading edge of RAM. 


To modify the ZPU card so that it will work with NICE, tie up pin #1 of 1C32 
(floating is acceptable), This modifies the ZPU so that the Data Bus In is not 
disabled following the leading edge of MREQ. 


cz Nicolet 69 


70 


APPENDIX D APPENDIX D 
QUIT MODE REFRESH CYCLES FOR NICE ADDITIONAL TIMING REQUIREMENTS FOR NICE MEMORY OR I/O CYCLES* 


ff. Si a: ara: 


These requireinents do not apply when NICE is in 


Men Pat spomthec 


ey s ol ag eat ges Se ee oe a 


c= Nicolet x Nicolet 7 


1 
i] 


APPENDIX E 
SAMPLE DOWNLOAD PROGRAM USING THE R COMMAND 


INDEX 


(Commands appear in boldface) 


A 
Assemble IntoRAM. .- 6-2-2 eee ete tt tts 35 - 36 
Auto Baud Rate Detection. - - - 6 6 6 ee wee ee eee 5 
B 
BreakPoint) © sen = 22h we Ee He pe eS oY Bie 15 
Break: Point:Count 4.4 5 2 ip See St Hew et 16-17 
BNSF GcieST Ss tecsairwe dice, elon asi ars ee Ke Secon ns ae Re Uomis ete agi pnts 11 
G 
CODGDITT ies seis fe aeduse tai eicei uate etek oy weer ec Ta Me Eats eomegate he. a) se Meas 3 
Conmieanditconmat: laps w oo oo eral eo) mieren le pee ee ee 8 
Command Line Interpreter. - .---: - 4, 10 
Gommonicathions Gable: = + - hes 6 & eens ee 
CommunicationSiConnector’ < seus 6 wee ee ee Se 8 6-7 
Controlicharacteysi= os S fess as © Stes Sw we we Oe 9 
D 
DataGonputemend «cee cee 6 cr ee wis . 6-7 
Datoclermminalind suia == = Gino «© © amas aS os . 6-7 
PSS yar os er ene este ance Seed ene S \Giane 
Delay 
Disable Break Point... 2... 1. eee ee 18-19 
Disable Bus RP Peay (al oer en ican oh ne ae NS 24 - 25 
Disoble Interrupts: 67. 5 Stas ss 22 - 23 
Disable Print: Point «55%. © fc m 5 3 4 2 oes 
yg alas fe a Pon Ce THRE DIA Up: re ee ue eee ee BT 26 - 27 
Display: Meriory: = «26s Ss RecA a Mh em Se Se eH Ge es 37 - 38 
Rs cere Bo we Sie ie Re Ge) ee a ee a er 6-7 
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Erohle BreakPoint’ 6.6 6 ccck Gb eee eee Oe TSS ES Memory Refresh - - 6 2 2 8 2 6 ee eee o Fer cae ello) we ox. thes owes 12 
Prcistos Cae det os eee ee te SP nee TAO PRS Pee en IIe Memory Requests: - +--+ °° Sled. er SRV Le) REE ONY hee ifs SO 
Enable Interrupts... ..--. - eve ene Gus: Ss oe tie aee Memory Test i285 9 ee ee ees UES AEA hee are 
Encble Print Points & csi ee IS Gok Kee ee ee pe NG Sar) ee ee Gree = uN atu ee Sy ceases oe Us a ey ah i 
Enanle Hefreshited 2 itso Soh a ee ees een hee 5, Multiple Commands On One Line + + +--+ + se te fw Su ey a oe 
ERR ctor titar ant na Ake ents oe BEC ee Ew ree ne Ren eee, Multiple Parameters - - + + + =: SA a cas NY Rat See A awe 
Examine Input Port... ........ MRT Lani ee why er a RL oe eee eos 

EN MCUT OR Goncvecs oh is Maer ae en Seek eh. ae eae Mires Paty atieachel demic) O 


|| Dee eer cme Cup rae re anal ae are ates he een en ine egies 


Peaks ond Valleys Test © © 9+ + se ee te eee apie ees 
G Pin Connections - «= - +--+ 2+ ++ ee ee ee ron cb ny Wee eer An et a 
Gay Eee chee COIS ricer Seat Baye b deiag) GR tenia eS te ea ay aD Powers: ¢ Wie Side 20 eel eS Re Ee) ye ON 
Se Mode: faccvises saps are’ a Ee mise rhe we Oy na oes Omer ENE a AP VA GST SO TR aig 1] PROCDIS Sw tas ooh te el Sh miele: a 1 ele 6 MWe 
Definition. = «iis 2 vp bem hat ee Tre eta a rete JE 
Ommands: | Saictevn s kepeeeto! ny er fs etc A itr eee ae 14 - 33, 65 - 66 ; Q 
Quits bare Parisi Get uae eee Merete yy tera Cera oe he Oe 
H GUPEMOdE 6 ie ee we ees Sip ae tLe See we eeehsiey! Wl ge eset an ee 


Hexadecimal Arithmetic ........2... AL Ne aE enh ee SO Definitions «5 & & sia » Sh pital w Wg) ites ey gral ge. Stel 
OTIS sentirne onl cata ees ere In eo .... . 34-61, 62 - 64, 65 - 66 


ons 


installation: ro 4 = amos 2 eS PGR ash aac eee eee et leucine ahh R 
i Readilntel ethiles, sar cs cosas, SEO GLS Sh Re Gem we Ene ae OER 


Ingterruptsice wos: te 2) @ ek ter os : 
IO’ Reckinsta on eee eee nee ae ae Marae Benet Cc cee Repeating... 6. 2-5 - ee ee ee ee Be 


Renear line: Command: 36% = sso a'5 sn & Se Anew nent aeree ML 

L Reset Status; =< G1 41s.) oe = See Esa) Hie nee ee 
Bengthiegs (mere siankce eran cmt aren et eee Cor Renee na age a PAT ee PCN VINO EL Inacio tiers mitin Clie ART Asioss tesa vapmet cote Se aCe eee: 
List in Assembler Format ......... ert: BA Dips ees Pee RUNNING: 0 = y sof ae sw Gale Pear euaeee SO pera aseaciee xe alll 
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Scope Loops 

Heh rigs DA Site OP es Sl ap ord | Rca en eS 
SOR Reset cmc sty sn sre os ee ar ee le ee oe ee is ee al es 
WPOGRS ATi te Waser coaremtalaes jeitiesrunicy ae <cerveeal hare Tara aS AT ee 8 
Shatusincc sis. wher Ani er a Bel ey ee bere ee ete ae 
Substitute Into Memory. . - .. . Picecren el pe es Pei colipates xo cee wee te 


Target Disturbance 
herminglGharasteristies:sc-. 5 aneciaves eo heoas en eee ES ae 5 
PEON Bees Vetoes he Pre uN ER Un pice oP ei ney ty) ee ee 6) DOS: 


MIMEEOCE ria st eet oe Reis ee ese EL yey SR ae Gy 
Ahh (ice ee Obata tees nee A etter eal NE) ee ane oh Ve ced: ace) 


MOMINO: Gros Boe en & ROKR See 2 ONE 
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For applications assistance please contact us on our Logic Analyzer 


Technical Hotline: 


800/NICOLET (642-6538) - Toll Free Outside California 
415/490-8300 - California 


NICOLET PARATRONICS CORPORATION 
201 Fourier Avenve 
Fremont, California 94539 
TWX: 910/381-7030 


)  ——— 
NICE USER'S GUIDE UPDATE 


—— ————— ———————  ——_B_ ee 


This update revises the emulator commands for the TRACE an 


UNTRACE functions and adds a new command for a CLEAR functior 


The TRACE command, T, pages 34, 54, and 63, of the Guide hav 
been changed to .T and -T dl6. The UNTRACE command, U, page 


34, 56, and 63, of the Guide have been changed to .U and -U dl6. 


The new CLEAR command, .C, has been added to clear a 
breakpoints and printpoints. Since the breakpoints and printpoin' 
are uncontrolled at powerup and upon reset, it is important 1 


perform the CLEAR function after power up and after each reset. 


CAUTION: Use of the T only or U only commands without the 
. (dot) may result in destruction of data in a 


control register! 


a 
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NICE NEWSLETTER 


Nicolet is nearing the end of the second month of shipments of the NICE emulator. We 


have received a number of good comments, which we appreciate. We have also had a few 


problems which have inconvenienced some of you, and for this we apologize. 


We would like to take this opportunity to summarize some of the common problems and 


the resolution of them. We will also mention a few of the unique problems with the 


request that if you have experienced a similar problem and resolved it, you will pass the 


information on to us. 


I. COMMON PROBLEMS 


ie 


Units through Serial #1070 experienced a malfunction when using TRACE (T) and 
UNTRACE (U) commands. This was remedied by adding the .C command and 
changing the TRACE command to .T and the UNTRACE to .U. 


On all units, the SUBSTITUTE INTO MEMORY command S was inadvertantly left 
in the User's Guide. The only form of the substitute command is S START- 
ADDRESS. 


The pin assignments for setting up the communications connector as described on 
page 6 of the User's Guide are incorrect. Received Data should read PIN 3 (PIN 
2) and Transmitted Data should read PIN 2 (PIN 3). 


For those user's who may be establishing a communications interface other than 
with the RS232 cable supplied, please note that there may be a degradation in 
the performance of NICE as the cable length is extended. 


Pages 36 and 43 of the manual show examples of assembly and disassemblys, 
commands "A" and "L". The mnemonics displayed at address 8009 should read JR 
NZ, S-4 and at address 800D, JR S-9. 


Vicolet Paratronics Corporation 


7,201 Fourier Ave 


nue 


Fremont, California 94539 


Il. UNIQUE PROBLEMS 


es 


3. 


NICE does not function properly with the Freedom 100 terminal. We have not 
had a chance to review specifications on this terminal and thus have not 


addressed this problem. 


User's with Prog Log target systems have experienced problems in reading the 
Z80 registers correctly. Upon entering the QUIT mode, all Z80 registers are 
filled with F's. An expianation of this probiem is as follows: The NICE unit uses 
the Z80 data bus of the target system. When NICE uses the bus, it drives MREQ, 
IORQ, RD and WR high. At this point the target system should not have any 
devices driving the Z80 data bus. If the target system does drive the Z80 data 
bus while no memory or I/O requests are being processed, NICE will not function 
properly. On the Pro Log, this problem was fixed by cutting one trace on the 
target board. Careful examination of system timing is essential if you have a 


similar problem. 


Downloading Intel Hex Files 


We have had one user indicate that he could download at 300 baud but not at 
9600 baud. The reason for this is that NICE processes data at approximately 300 
baud. NICE gives a Clear to Send signal for each byte of data. Thus the Clear 
to Send signal is present for one byte then is removed until that byte is 
processed. If the transmitting system is not monitoring or not observing the 
NICE Clear to Send signals, the NICE buffer will be overloaded causing NICE to 
fail. 


If you have a system that requires modification, such as the Cromenco ZPU 
described on page 69 of the User's Guide or the Pro Log previously described, we 
will be glad to supply you with such NICE specifications as are necessary to 


assist in identifying the modification. 


NOTE: If you intend to use your personal computer as the terminal, you will 


need to develop your own application program. 


